<!DOCTYPE html>
<html lang="en">
<head>
	<meta charset="UTF-8">
	<meta http-equiv="X-UA-Compatible" content="IE=edge">
    <meta name="viewport" content="width=device-width, initial-scale=1">
	<title>bool 查询 | ElasticSearch 7.7 权威指南中文版</title>
	<meta name="keywords" content="ElasticSearch 权威指南中文版, elasticsearch 7, es7, 实时数据分析，实时数据检索" />
    <meta name="description" content="ElasticSearch 权威指南中文版, elasticsearch 7, es7, 实时数据分析，实时数据检索" />
    <!-- Give IE8 a fighting chance -->
    <!--[if lt IE 9]>
    <script src="https://oss.maxcdn.com/html5shiv/3.7.2/html5shiv.min.js"></script>
    <script src="https://oss.maxcdn.com/respond/1.4.2/respond.min.js"></script>
    <![endif]-->
	<link rel="stylesheet" type="text/css" href="../static/styles.css" />
	<script>
	var _link = 'query-dsl-bool-query.html';
    </script>
</head>
<body>
<div class="main-container">
    <section id="content">
        <div class="content-wrapper">
            <section id="guide" lang="zh_cn">
                <div class="container">
                    <div class="row">
                        <div class="col-xs-12 col-sm-8 col-md-8 guide-section">
                            <div style="color:gray; word-break: break-all; font-size:12px;">原英文版地址: <a href="https://www.elastic.co/guide/en/elasticsearch/reference/7.7/query-dsl-bool-query.html" rel="nofollow" target="_blank">https://www.elastic.co/guide/en/elasticsearch/reference/7.7/query-dsl-bool-query.html</a>, 原文档版权归 www.elastic.co 所有<br/>本地英文版地址: <a href="../en/query-dsl-bool-query.html" rel="nofollow" target="_blank">../en/query-dsl-bool-query.html</a></div>
                        <!-- start body -->
                  <div class="page_header">
<strong>重要</strong>: 此版本不会发布额外的bug修复或文档更新。最新信息请参考 <a href="https://www.elastic.co/guide/en/elasticsearch/reference/current/index.html" rel="nofollow">当前版本文档</a>。
</div>
<div id="content">
<div class="breadcrumbs">
<span class="breadcrumb-link"><a href="index.html">Elasticsearch 权威指南 [7.7]</a></span>
»
<span class="breadcrumb-link"><a href="query-dsl.html">查询领域特定语言(Query DSL)</a></span>
»
<span class="breadcrumb-link"><a href="compound-queries.html">复合查询</a></span>
»
<span class="breadcrumb-node">bool 查询</span>
</div>
<div class="navheader">
<span class="prev">
<a href="compound-queries.html">« 复合查询</a>
</span>
<span class="next">
<a href="query-dsl-boosting-query.html">boosting 查询 »</a>
</span>
</div>
<div class="section">
<div class="titlepage"><div><div>
<h2 class="title">
<a id="query-dsl-bool-query"></a>bool 查询
</h2>
</div></div></div>

<p>
匹配与其他查询的布尔(bool)组合相匹配的文档的查询。

bool 查询映射到 Lucene 的 <code class="literal">BooleanQuery</code>。

它使用一个或多个布尔子句构建，每个子句都有一个类型的出现。

出现的类型包括：
</p>
<div class="informaltable">
<table border="1" cellpadding="4px">
<colgroup>
<col class="col_1">
<col class="col_2">
</colgroup>
<thead>
<tr>
<th align="left" valign="top">出现</th>
<th align="left" valign="top">描述</th>
</tr>
</thead>
<tbody>
<tr>
<td align="left" valign="top"><p><code class="literal">must</code></p></td>
<td align="left" valign="top"><p>
该子句(查询)必须出现在匹配的文档中，并且将参与计算得分。
</p></td>
</tr>
<tr>
<td align="left" valign="top"><p><code class="literal">filter</code></p></td>
<td align="left" valign="top"><p>
该子句(查询)必须出现在匹配的文档中。

然而，与 <code class="literal">must</code> 不同，该查询的分数将被忽略。

filter 子句在 <a class="xref" href="query-filter-context.html" title="Query and filter context">filter 的上下文</a>中执行，这意味着该字句的评分会被忽略，但会考虑对该字句进行缓存。
</p></td>
</tr>
<tr>
<td align="left" valign="top"><p><code class="literal">should</code></p></td>
<td align="left" valign="top"><p>
该子句(查询) 应该(should) 出现在匹配的文档中。
</p></td>
</tr>
<tr>
<td align="left" valign="top"><p><code class="literal">must_not</code></p></td>
<td align="left" valign="top"><p>
该子句(查询)不能出现在匹配的文档中。

该子句在 <a class="xref" href="query-filter-context.html" title="Query and filter context">filter 的上下文</a>中执行，这意味着该字句的评分会被忽略，但会考虑对该字句进行缓存。

因为评分被忽略，所以所有文档都返回<code class="literal">0</code>分。
</p></td>
</tr>
</tbody>
</table>
</div>
<p>
bool 查询采用<em>越匹配越好(more-matches-is-better)</em>的方法，因此每个匹配的 <code class="literal">must</code> 或 <code class="literal">should</code> 子句的分数将被加在一起，以提供每个文档的最终的<code class="literal">_score</code>。
</p>
<div class="pre_wrapper lang-console">
<pre class="programlisting prettyprint lang-console">POST _search
{
  "query": {
    "bool" : {
      "must" : {
        "term" : { "user" : "kimchy" }
      },
      "filter": {
        "term" : { "tag" : "tech" }
      },
      "must_not" : {
        "range" : {
          "age" : { "gte" : 10, "lte" : 20 }
        }
      },
      "should" : [
        { "term" : { "tag" : "wow" } },
        { "term" : { "tag" : "elasticsearch" } }
      ],
      "minimum_should_match" : 1,
      "boost" : 1.0
    }
  }
}</pre>
</div>
<div class="console_widget" data-snippet="snippets/93.console"></div>
<div class="section">
<div class="titlepage"><div><div>
<h3 class="title">
<a id="bool-min-should-match"></a>使用 <code class="literal">minimum_should_match</code>
</h3>
</div></div></div>
<p>
可以使用 <code class="literal">minimum_should_match</code> 参数来指定返回文档 <em>必须(must)</em> 匹配的<code class="literal">should</code>子句的数量或百分比。
</p>
<p>
如果 <code class="literal">bool</code> 查询至少包含一个 <code class="literal">should</code> 子句，并且没有 <code class="literal">must</code> 或 <code class="literal">filter</code> 子句，则默认值为 <code class="literal">1</code>。

否则，默认值为 <code class="literal">0</code>。
</p>
<p>
关于其他可用的值, 参考 <a class="xref" href="query-dsl-minimum-should-match.html" title="minimum_should_match parameter"><code class="literal">minimum_should_match</code> 参数</a>。
</p>
</div>

<div class="section">
<div class="titlepage"><div><div>
<h3 class="title">
<a id="score-bool-filter"></a>用 <code class="literal">bool.filter</code> 评分
</div></div></div>
<p>
<code class="literal">filter</code> 元素下指定的查询对评分没有影响，因为返回的分数都是 <code class="literal">0</code>。

分数只受已指定的查询的影响。

例如，以下三个查询都返回 <code class="literal">status</code> 字段包含词项 <code class="literal">active</code> 的所有文档。
</p>
<p>
第一个查询为所有文档分配 <code class="literal">0</code> 分，因为没有指定计分的查询：
</p>
<div class="pre_wrapper lang-console">
<pre class="programlisting prettyprint lang-console">GET _search
{
  "query": {
    "bool": {
      "filter": {
        "term": {
          "status": "active"
        }
      }
    }
  }
}</pre>
</div>
<div class="console_widget" data-snippet="snippets/94.console"></div>
<p>
下面这个 <code class="literal">bool</code> 查询有一个 <code class="literal">match_all</code> 查询，它给所有文档分配 <code class="literal">1.0</code> 分。
</p>
<div class="pre_wrapper lang-console">
<pre class="programlisting prettyprint lang-console">GET _search
{
  "query": {
    "bool": {
      "must": {
        "match_all": {}
      },
      "filter": {
        "term": {
          "status": "active"
        }
      }
    }
  }
}</pre>
</div>
<div class="console_widget" data-snippet="snippets/95.console"></div>
<p>

第三个例子, 下面这个 <code class="literal">constant_score</code> 查询的行为与上面的第二个示例完全相同。<code class="literal">constant_score</code> 查询将分数 <code class="literal">1.0</code> 分配给与过滤器匹配的所有文档。
</p>
<div class="pre_wrapper lang-console">
<pre class="programlisting prettyprint lang-console">GET _search
{
  "query": {
    "constant_score": {
      "filter": {
        "term": {
          "status": "active"
        }
      }
    }
  }
}</pre>
</div>
<div class="console_widget" data-snippet="snippets/96.console"></div>
</div>

<div class="section">
<div class="titlepage"><div><div>
<h3 class="title">
<a id="_using_named_queries_to_see_which_clauses_matched"></a>使用命名查询(named queries)查看哪些子句匹配
</h3>
</div></div></div>
<p>
如果需要知道 bool 查询中的哪个子句与查询返回的文档相匹配，可以使用 <a class="xref" href="search-request-body.html#request-body-search-queries-and-filters" title="Named Queries">命名查询(named queries)</a> 为每个子句指定一个名称。
</p>
</div>

</div>
<div class="navfooter">
<span class="prev">
<a href="compound-queries.html">« 复合查询</a>
</span>
<span class="next">
<a href="query-dsl-boosting-query.html">boosting 查询 »</a>
</span>
</div>
</div>

                  <!-- end body -->
                        </div>
                        <div class="col-xs-12 col-sm-4 col-md-4" id="right_col">
                        
                        </div>
                    </div>
                </div>
            </section>
        </div>
    </section>
</div>
<script src="../static/cn.js"></script>
</body>
</html>